package com.hmall.api.client;

import com.hmall.api.client.fallback.ItemClientFallbackFactory;
import com.hmall.api.dto.ItemDTO;
import com.hmall.api.dto.OrderDetailDTO;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;

import java.util.Collection;
import java.util.List;

/**
 * @Classname ItemClient
 * @Date 2024/11/25 20:19
 * @Created by 鲍宪立
 */
@FeignClient(value = "item-service",
        fallbackFactory = ItemClientFallbackFactory.class)//value是服务提供者的名称
public interface ItemClient {

    /**
     * - @FeignClient("item-service") ：声明服务名称
     * - @GetMapping ：声明请求方式
     * - @GetMapping("/items") ：声明请求路径
     * - @RequestParam("ids") Collection<Long> ids ：声明请求参数
     * - List<ItemDTO> ：返回值类型
     * @param ids
     * @return
     * 有了上述信息，OpenFeign就可以利用动态代理帮我们实现这个方法，并且向http://item-service/items发送一个GET请求，
     * 携带ids为请求参数，并自动将返回值处理为List<ItemDTO>。我们只需要直接调用这个方法，即可实现远程调用了。
     */
    @GetMapping("/items")
    List<ItemDTO> queryItemByIds(@RequestParam("ids") Collection<Long> ids);

    @PutMapping("/items/stock/deduct")
    void deductStock(@RequestBody List<OrderDetailDTO> detailDTOS);
}
